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Introduction 

System call is the services provided by Linux kernel. In C programming, it often uses functions defined in libc 
which provides a wrapper for many system calls. Manual page section 2 provides more information about 
system calls. To get an overview, use "man 2 intro" in a command shell. 

It is also possible to invoke syscallO function directly. Each system call has a function number defined in 
<syscall.h> or <umstd.h>. Intemally, system call is invokded by software interrupt 0x80 to transfer control to 
the kernel. System call table is defined in Linux kernel source file "arch/i386/kernel/entry.S ". 

System Call Example 

§±nclude <syscall.h> 
^include <unistd.h> 
^Include <stdio.h> 
^include <sys/types . h> 

int main (void) { 



long IDl, ID2; 

/* */ 

/* direct system call */ 

/* SYS_getpid (func no. is 20) */ 
/* */ 

IDl = syscall (SYS_getpid) ; 

print f ("syscall(SYS_getpid)=%ld\n", IDl); 

/* */ 

/* "libc" wrapped system call */ 
/* SYS_getpid (Func No. is 20) */ 
/* */ 

ID2 = getpidO; 



printf ("getpid()=%ld\n", ID2) ; 
return (0) ; 

} 



System Call Quick Reference 



No 


Func Name 


Description 


Source 


1 


exit 


terminate the current process 


kemel/exit.c 


2 


fork 


create a child process 


arch/i386/kerneI/process. c 


3 


read 


read from a file descriptor 


fs/read_write. c 


4 


write 


write to a file descriptor 


fs/read_write. c 


5 


open 


open a file or device 


fs/open.c 


6 


close 


close a file descriptor 


fs/open.c 


7 


waitoid 


wait for process termination 


kemel/exit.c 



8 


creat 


create a file or device ("man 2 open" for 
information) 


fs/open.c 


9 


link 


make a new name for a file 


fs/namei.c 


10 


unlink 


delete a name and possibly the file it refers to 


fs/namei.c 


11 


execve 


execute program 


arch/i386/kernel/process.c 


12 


clidir 


change working directory 


fs/open.c 


13 


time 


get time in seconds 


kernel/time. c 


14 


mknod 


create a special or ordinary file 


fs/namei.c 


15 


chmod 


change permissions of a file 


fs/open.c 


16 


Icliown 


change ownership of a file 


fs/open.c 


18 


Stat 


get file status 


fs/stat.c 


19 


Iseek 


reposition read/write file offset 


fs/read_write. c 


20 


setpid 


get process identification 


kemel/sc}ied.c 


21 


mount 


mount filesystems 


fs/super.c 


22 


umount 


unmount filesystems 


fs/super.c 


23 


setuid 


set real user ID 


kernel/sys.c 


24 


s:etuid 


get real user ID 


kemel/sched.c 


Z5 


stime 


set system time and date 


kemel/tifne.c 


26 


ptrace 


allows a parent process to control the execution of 
a child process 


£irch/i386/kerfiel/ptrace. c 


27 


alarm 


set an alarm clock for delivery of a signal 


kernel/sched.c 


28 


fstat 


get file status 


fs/stat.c 


29 


pause 


suspend process until signal 


arch/i386Aemel/sys_i386. c 


30 


utime 


set file access and modification times 


fs/open.c 


33 


access 


check user's permissions for a file 


fs/open.c 


34 


nice 


change process priority 


kemel/sciied.c 


36 


sync 


update the super block 


fs/bujfer.c 


37 


kill 


send signal to a process 


kemel/signal.c 


38 


rename 


change the name or location of a file 


fs/namei.c 


39 


mkdir 


create a directory 


fs/namei.c 


40 


rmdir 


remove a directory 


fs/namei.c 


41 


dup 


duphcate an open file descriptor 


fs/fcntl.c 


42 


pipe 


create an interprocess channel 


arch/i386/kemel/sys_i386. c 


A'X 


times 


gCL piUCCsS Liillca 


kernel/ sys. c 


45 


brk 


ciidiii^c ulc aiiiuuiiL ui space diiocaLcu lui uic 
calling process's data segment 


mm/mmap. c 


46 


setgid 


set real group ID 


kemel/sys.c 


47 


getgid 


get real group ID 


kemel/sched.c 


48 


svs signal 


ANSI C signal handling 


kernel/signal.c 


49 


geteuid 


get effective user ID 


kemel/sched.c 


50 


getegid 


get effective group ID 


kemel/sched.c 



51 


acct 


enable or disable process accounting 


kemel/acct.c 


52 


uinount2 


unmount a file system 


fs/super.c 


54 


ioctl 


control device 


fs/ioctl.c 


55 


fcntl 


file control 


fs/fcntl.c 


56 


mpx 


(unimplemented) 




57 


setpgid 


set process group ID 


kernel/sys.c 


58 


ulimit 


(unimplemented) 




59 


olduname 


obsolete uname system call 


arch/i386/kernel/sys_i386. c 


60 


umask 


set file creation mask 


kernel/sys.c 


61 


chroot 


change root directory 


fs/open.c 


62 


ustat 


get file system statistics 


fs/super.c 


63 


dup2 


duplicate a file descriptor 


fs/fcntl.c 


64 


getppid 


get parent process ID 


kemel/sched.c 


65 


getpsrp 


get the process group ID 


kernel/sys.c 


66 


setsid 


creates a session and sets the process group ID 


kernel/sys.c 


67 


sigaction 


POSIX signal handling functions 


arch/i386/kernel/signal. c 


68 


sgetmask 


ANSI C signal handUng 


kernel/signal. c 


69 


ssetmask 


ANSI C signal handling 


kernel/signal. c 


70 


setreuid 


set real and effective user IDs 


kernel/sys.c 


71 


setregid 


set real and effective group IDs 


kernel/sys.c 


72 


sigsuspend 


install a signal mask and suspend caller until 
signal 


circl'i/i386/kemel/signcil. c 


73 


sigpending 


examine signals that are blocked and pending 


kernel/signal. c 


74 


sethostname 


set hostname 


kernel/sys.c 


75 


setrlimit 


set maximum system resource con sumption 


kernel/sys.c 


76 


getrlimit 


get maximum system resource con sumption 


kernel/sys.c 


77 


getrusage 


get maximum system resource con sumption 


kernel/sys.c 


78 


gettimeofdav 


get the date and time 


kemeVtime.c 


79 


settimeofdav 


set the date and time 


kernel/time. c 


80 


getgroups 


get hst of supplementary group IDs 


kernel/sys.c 


81 


setgroups 


set list of supplementary group IDs 


kernel/sys.c 


82 


old select 


sync. I/O multiplexing 


arch/i386/kemel/sys_i386. c 


83 


svmlink 


make a symbolic link to a file 


fs/namei.c 


84 


Istat 


get file status 


fs/stat.c 


85 


readlink 


read the contents of a symbolic link 


fs/stat.c 


86 


uselib 


select shared library 


fs/exec.c 


87 


swapon 


start swapping to file/device 


mm/swapfile.c 


88 


reboot 


reboot or enable/disable Ctrl- Alt -Del 


kernel/sys.c 


89 


old readdir 


read directory entry 


fs/readdir.c 


90 


old mmap 


map pages of memory 


arcM386/kernel/sys_i386. c 



91 


munmap 


unmap pages of memory 


mm/mmap.c 


92 


trancate 


set a file to a specified length 


fs/open.c 


93 


ftruncate 


set a file to a specified length 


fs/open.c 


94 


fchmod 


change access permission mode of file 


fs/open.c 


95 


fchown 


change owner and group of a file 


fs/open.c 


96 


getprioritv 


get program scheduling priority 


kernel/sys.c 


97 


setprioritv 


set program scheduhng priority 


kernel/sys.c 


98 


profil 


execut ion time profile 




99 


statfs 


get file system statistics 


fs/open.c 


100 


fstatfs 


get file system statistics 


fs/open.c 


101 


ioperm 


set port input/output permissions 


arch/i386/kernel/ioport. c 


102 


socketcall 


socket system calls 


net/so cket.c 


103 


svslog 


read and/or clear kernel message ring buffer 


keniel/printk.c 


104 


seti timer 


set value of interval timer 


keniel/itimer.c 


105 


geti timer 


get value of interval timer 


kernel/itimer.c 


106 


sys newstat 


get file status 


fs/stat.c 


107 


sys newlstat 


get file status 


fs/stat.c 


108 


sys_newfstat 


get file status 


fs/stat.c 


109 


olckmame 


get name and information about current kernel 


arch/i386/kernel/sys_i386. c 


110 


iopl 


change I/O privilege level 


arch/i386/kernel/ioport. c 


111 


vhangup 


virtually hangup the current tty 


fs/open.c 


112 


idle 


make process 0 idle 


arch/i386/kernel/process.c 


113 


vm86oId 


enter virtual 8086 mode 


arch/i386/kernel/vm86. c 


114 


wait4 


wait for process termination, BSD style 


kernel/exit. c 


115 


swapoff 


stop swapping to file/device 


mm/swapfile.c 


116 


svsinfo 


returns information on overall system statistics 


kernel/info. c 


117 


ipc 


System V IPC system calls 


arch/i386/kemel/sys_i386. c 


118 


fsvnc 


synchronize a file's complete in-core Sate with that fs/buffer.c 
on disk 


119 


sigretum 


retum from signal handler and cleanup stack 
frame 


arch/i386/kemel/signal.c 


120 


clone 


create a child process 


arch/i386/kernel/process.c 


121 


setdomainname 


set domain name 


kernel/sys.c 


122 


uname 


get name and information about current kernel 


kernel/sys.c 


123 


modify Idt 


get or set Idt 


arch/i386/kernel/ldt. c 


124 


aditimex 


tune kernel clock 


kemeVtime.c 


125 


mprotect 


set protection of memory mapping 


mm/mprotect.c 


126 


sigprocmask 


POSIX signal handling functions 


kernel/signal. c 


127 


create module 


create a loadable module entry 


kernel/module, c 


128 


init module 


initialize a loadable module entry 


kernel/module, c 


129 


delete module 


delete a loadable module entry 


kernel/module, c 



130 


get kernel syms 


retrieve exported kernel and module symbols 


kernel/module, c 


131 


quotactl 


manipulate disk quotas 


fs/dquot.c 


132 


getpsid 


get process group ID 


kernel/sys.c 


133 


fchdir 


change working directory 


fs/open.c 


134 


bdflush 


start, flush, or tune buffer-dirty-flush daemon 


fs/bujfer.c 


135 


sysfs 


get file system type information 


fs/super.c 


136 


nersonalitv 


set the process execution domain 


kemel/exec_domain.c 


137 


afs svscall 


(unimplemented) 




138 


setfsuid 


set user identity used for file system checks 


kernel/sys.c 


139 


setfsgid 


set group identity used for file system checks 


kernel/sys.c 


140 


svs llseek 


move extended read/write file pointer 


fs/readjivrite. c 


141 


getdents 


read directory entries 


fs/readdir.c 


142 


select 


sync. I/O multiplexing 


fs/select.c 


143 


flock 


apply or remove an advisory lock on an open file 


fs/locks.c 


144 


msvnc 


synchronize a file with a memory map 


mm/filemap.c 


145 


readv 


read data into multiple buffers 


fs/read_write. c 


146 


writev 


write data into multiple buffers 


fs/read_write. c 


147 


svs getsid 


get process group ID of session leader 


kernel/sys.c 


148 


fdatasvnc 


synchronize a file's in -core data with that on disk 


fs/bujfer.c 


149 


svsctl 


read/write system parameters 


kernel/sysctl.c 


150 


mlock 


lock pages in memory 


mm/mlock.c 


151 


munlock 


unlock pages in memory 


mm/mlock.c 


152 


mlockall 


disable paging for calling process 


mm/mlock.c 


153 


munlockall 


reenable paging for calling process 


mm/mlock.c 


154 


sched setparam 


set scheduling parameters 


kernel/sched.c 


155 


sched getparam 


get scheduling parameters 


kernel/sched.c 


156 


sched setscheduler 


set scheduling algorithm parameters 


kernel/sched.c 


157 


sched getscheduler 


get scheduling algorithm parameters 


kernel/sched.c 


158 


sched yield 


yield the processor 


kernel/sched.c 


159 


sched get priority 
max 


get max static priority range 


kernel/sched.c 


160 


sched get priority 
min 


get min static priority range 


kernel/sched.c 


161 


sched rr get inter 
val 


get the SCHED_RR interval for the named process 


kernel/sched.c 


162 


nanosleep 


pause execution for a specified time (nano seconds) 


kernel/sched.c 


163 


mremap 


re -map a virtual memory address 


mm/mremap.c 


164 


setresuid 


set real, effective and saved user or group ID 


kernel/sys.c 


165 


getresuid 


get real, effective and saved user or group ID 


kernel/sys.c 


166 


vm86 


enter virtual 8086 mode 


arch/i386/kernel/vm8(. 



167 


query module 


cjuery the kernel for various bits pertain ing to 
modules 


kernel/module. c 


168 


poU 


wait for some event on a file descriptor 


fs/select.c 


169 


nfsseryctl 


syscall interface to kernel nfs daemon 


fs/filesystems.c 


170 


setresgid 


set real, effective and saved user or group ID 


kernel/sys.c 


171 


getresgid 


get real, effective and saved user or group ID 


kernel/sys.c 


172 


prctl 


operations on a process 


kernel/sys.c 


173 


rt_sigreturn 




arch/i386/kemel/signal. c 


174 


rt sigaction 




kernel/signal. c 


175 


rt sigprocmask 




kernel/signal. c 


176 


rt sigpending 




kernel/signal. c 


177 


rt sigtimedwait 




kernel/signal.c 


178 


rt sigqueueinfo 




kernel/signal. c 


179 


rt sigsuspend 




arch/i386/kernel/signal.c 


180 


pread 


read from a file descriptor at a given offset 


fs/read_write. c 


181 


sys pwrite 


write to a file descriptor at a given offset 


fs/read_write. c 


182 


chown 


change ownership of a file 


fs/open.c 


183 


getcwd 


Get current working directory 


fs/dcache.c 


184 


capget 


get process capabilities 


kernel/capability. c 


185 


capset 


set process capabilities 


kernel/capability, c 


186 


sigaltstack 


set/get signal stack context 


arch/i386/kernel/signal. c 


187 


sendfile 


transfer data between file descriptors 


mm/filemap.c 


188 


getpmsg 


(uninplemented) 




189 


putpmsg 


(unimplemented) 




190 


yfork 


create a child process and block parent 


arch/i386/kemel/process. 



